Configuring Classification Based on Tags
You can classify incoming SIP dialogs to IP Groups, using tags (source tags) that are obtained from Call Setup Rules associated with the SIP Interfaces on which dialogs are received. Using tags can significantly reduce the number of required Classification rules. In some scenarios, a single Classification rule may suffice.
Classification based on tags includes the following stages:
| 1. | The device determines the tag of the incoming SIP dialog by running a Call Setup Rule that is associated with the SIP Interface on which the dialog is received. The Call Setup Rule on SIP Interfaces can be based only on synchronous queries. You can configure the Call Setup Rule to generate a tag with a name and value (e.g., "Country=Ireland") or only a value (e.g., "Ireland"). |
| 2. | The device searches the Classification table for a matching rule based on the SIP Interface (and optionally, any other existing matching properties) as well as the tag. The tag can be a name (e.g., "Country"), or "default" if the tag only has a value (e.g., "Ireland"). |
| 3. | The device searches the IP Groups table for an IP Group that is configured with the tag from the Call Setup Rule (name=value or value only) and if found, classifies the dialog to that IP Group. |
| ● | Classification based on tags is done only if classification based on user registration and Proxy Set fail. |
| ● | The IP Group Set table is not used for classification (i.e., ignores tags). |
The following procedure describes how to configure incoming SIP dialog classification based on tags. The procedure is based on an example that uses Dial Plan tags to classify calls to three different IP Groups:
| ■ | Calls with source number (user) 410 are classified to IP Group-1 |
| ■ | Calls with source number (user) 420 are classified to IP Group-2 |
| ■ | Calls with source number (user) 430 are classified to IP Group-3 |
| ➢ | To configure Classification based on tags: |
| 1. | Open the Dial Plan table (see Configuring Dial Plans), and then configure Dial Plan tags. In our example, the following Dial Plan rules are configured for Dial Plan "ITSP": |
|
Name |
Prefix |
Tag |
|---|---|---|
|
Rule1 |
410 |
Country=Ireland |
|
Rule2 |
420 |
Country=Scotland |
|
Rule3 |
430 |
Country=England |
| 2. | Open the Call Setup Rules table (see Configuring Call Setup Rules), and then configure Call Setup Rules for obtaining source tags of incoming SIP dialogs. In our example, the following Call Setup Rule is configured: |
|
General |
|
|---|---|
|
'Rules Set ID' |
1 |
|
'Request Type' |
Dial Plan |
|
'Request Target' |
ITSP |
|
'Request Key' |
Param.Call.Src.User |
|
'Condition ' |
DialPlan.Found exists |
|
Action |
|
|
'Action Subject' |
SrcTags |
|
'Action Type' |
Modify |
|
'Action Value' |
DialPlan.Result |
| 3. | Open the SIP Interfaces table (see Configuring SIP Interfaces), and then configure a SIP Interface with the 'Call Setup Rules Set ID' parameter set to the 'Rules Set ID' value of your Call Setup Rules. In our example, the SIP Interface is named "SIPIfx-Tags" and the parameter is configured to 1. |
| 4. | Open the Classification table, and then configure a rule with the following: |
|
Match |
|
|---|---|
|
'Source SIP Interface' |
SIPIfx-Tags (or select Any) |
|
Action |
|
|
'IP Group Selection' |
Tagged IP Group |
|
'IP Group Tag Name' |
Country
Note: Enter the tag's name only. If the tag only has a value, then enter "default" (without quotation marks). |
| 5. | Open the IP Groups table (see Configuring IP Groups), and then configure IP Groups with the 'Tags' parameter set to the appropriate tag. If the source tag has a name and value, then configure the parameter as name=value (e.g., "Country=Ireland"). If it only has a value, then configure it with the value. In our example, the following IP Groups are configured: |
|
Name |
Tags |
|---|---|
|
IPGroup-1 |
Country=Ireland |
|
IPGroup-2 |
Country=Scotland |
|
IPGroup-3 |
Country=England |